LOGIC 2000 February/LogicCd--feb.2000-mac-cdr.iso/Apple II/CHANGEAFILE/CHG.FIL.DOC

AppleWorks Document | 1993-01-27 | 19.0 KB | 321 lines | [p?/pdos]

O=====<=======<===<=============================================================
O========<=====<================================================================
L- Strip Line Feed after Carriage Returng
CHANGE-A-FILE
Harold D. Portnoy
======================================================================
Be sure to copy CHANGE-A-FILE before using!!!
---------------
G     CHANGE-A-FILE is distributed partly FREE (5 utilities) and partly H
Fas SHAREWARE (6 utilities). The following utilities are shareware and
require a password:
     Convert AWP File to TXT File#
Convert TXT File to AWP File"
Convert AWP 3.0 to 2.x File,
AWP File Doctor  - AWP repair utility,
Exhume AWP File  - AWP repair utility,
Restore ADB File - ADB repair utility
The same password also unlocks the Auto-Restore functions of the H
FAppleWorks file repair program, RESURRECTION, which can recover files )
even when disk directories are damaged.
     To obtain the password, send $10.00 to:
       Change File
       c/o Harold D. Portnoy
       1431 Woodward#
       Bloomfield Hills, MI 48302
F     To obtain unlocked versions of Change-A-File and Resurrection on E
Ca disk including documentation and password (for future versions), 8
send $10.00 plus $4.00 for disk, postage and handling.
REGISTERED SHAREWARE USERS: If your password contains control I
Gcharacters then substitute the same regular characters for the control
characters in the password.
**********************************************************************
E     When an AppleWorks word processor or data base file goes bad is F
Dnot the time to worry about how you are going to repair the damage. ?
=AWP File Doctor and Restore ADB can repair these files. With H
FRESURRECTION, which can restore files from a bad directory, virtually D
Bany bad file can be restored. Each of these utilities, alone, are $
worth the small fee in time saved.
**********************************************************************
CHANGE-A-FILE                                               -      -
F     CHANGE-A-FILE is a batch file utility that reads AppleWorks Word I
GProcessor (AWP) and text (TXT) files; converts AWP files to TXT files, G
ETXT files to AWP files, and AWP 3.0 files to AWP 2.x files; restores G
Edamaged AWP and ADB (data base) files; change file or auxiliary type G
Ecodes, and strip or insert line feeds. Up to 88 files in a directory G
Eor subdirectory can be altered. This program uses the ProSel format. I
GCHANGE-A-FILE is particularly useful to the AppleWorks (AWKS) user and B
to prepare files for uploading or alter files after downloading.
Password
CHANGE-A-FILE is a system file. When run, the user is initially E
Cpresented with a password screen. Entering the password allows the H
Fuser to access all of the program's utilities. If the password is not G
Eentered only the first 5 utilities listed below can be accessed. The .
locked utilities will be shaded in the menu.
Activating protected utilities
 and removing password screen
Transfer Change-A_File, Resurrection, and the Password program H
Fto any directory. The Password program can be used on all versions of F
DResurrection, but only on version 4.14 or greater of Change-A-File. E
CThe Change-A-File program should be re-named CF.SYSTEM. Run either =
;CF.system or Password. Password can be used independent of H
FChange-A-File and can be used to unlock Resurrection alone. Enter the C
Apassword. Change-A-File will be unlocked and the password screen I
Gremoved. This is indicated by the notice 'CF.SYSTEM  unlocked'. Rename G
Ethe file to CHANGE.FILE or any other name of your choice. If you use H
FCF.system to unlock Change-A-File the password screen will be removed H
Fwhether you have the correct password or not. If you use the Password I
Gprogram, the screen is removed only if the password is correct. If you I
Genter the password, all the utilities will be able to be used. If not, 5
only the 'free' utilities will be able to be used. E
If RESURRECTION is placed in the same directory as CF.SYSTEM, C
Athe Auto-Restore functions will also be unlocked on entering the F
password. This is indicated by the notice 'RESURRECTION  unlocked'.
 Menu
The program menu is as follows:;
         ________________________________________________
Q- Quit
V- View"
F- Change File Info!
L- Strip Line Feed)
C- Strip Control Character"
I- Insert Line Feed%
X- AWP 3.0 to 2.x File&
W- AWP File to TXT File&
T- TXT File to AWP File!
E- Exhume AWP File!
D- AWP File Doctor"
R- Restore ADB File;
         ________________________________________________
E     The appropriate utility can be selected from the main menu with I
Gthe light bar selector, by entering the appropriate letter or by using G
Ethe mouse. Pressing RETURN, a letter or the mouse button accepts the
selection.
 Directory Selection
E     The volume directory name is the initial default directory. The G
Edefault source directory or destination directory can be accepted by H
Fpressing RETURN or mouse button. Any directory online can be entered. I
GThese directories will remain the default directories until changed or I
Gthe program is quit. The TAB key tabs to the next slash in a directory G
Epathname and then to the end of the pathname. Control-X switches the H
Fsource and destination directories. Control B or N move the cursor to H
Fthe beginning or end of the line. Control E inserts characters at the I
Gcursor. The DELETE key deletes the character to the left of the cursor 9
while control D deletes the character under the cursor.F
Alternately, the prefix can be selected by pressing the Closed H
FApple (Option) key. A list of directories is presented from which one H
Fcan be selected in a manner similar to that in AppleWorks (AWKS) 3.0. C
AThe up and down arrows or the mouse move the light bar selector, =
;RETURN or the mouse button selects a subdirectory and Open D
BApple-RETURN accepts the completed directory name. If an error is 4
made, pressing TAB lets you restart the selection.
File Selection
A     Files are selected or deselected with the spacebar or mouse D
Bbutton. A check mark is placed in front of the selected file. The G
Elight bar can be positioned using the four arrow keys or mouse. When H
Fusing the spacebar or mouse button to select a file, the selection is H
Fmade in the direction first initiated. Entering Control A selects all E
Cthe files. After selecting the desired files, press RETURN. ESCape &
always returns you to the main menu.
The Utilities
Convert AWP 3.0 to 2.x file.H
    Usually AWP files generated by Appleworks 3.0 cannot be read H
Fby versions 2.1 and below. If you do not have version 3.0, an AWP 3.0 G
Efile can be read by your version of Appleworks by converting the AWP H
F3.0 to an AWP 2.x file. The suffix ".X" is added to the file name. If @
>the original name is greater than 13 characters, the last two H
Fcharacters are replaced with the suffix. This utility is particularly E
Cuseful for those AWKS 3.0 users who would like to upload AWP files +
that can be read by all versions of AWKS.E
C     The AWP 3.0 file is not converted if it is already compatible I
Gwith the AWP 2.x format and the source and destination directories are D
Bthe same. This is indicated by a bell and a diamond replacing the
check mark.
Convert AWP to TXT file.G
E     This utility converts AWP files into text files. In preparation I
Gfor uploading, each line is followed by a carriage return. If you want I
Ga carriage return only at the end of a paragraph, press the Open Apple /
and RETURN keys when indicated on the screen.G
E     The text file created is designated by the suffix ".W" added to H
Fthe original file name. The original file is preserved. The auxiliary
file code is changed to $0000.
Convert TXT to AWP file.G
E     This utility converts TXT files into AWP files. The conversion, H
Fparticularly of multiple files, is considerably faster than using the F
DAppleWorks from text file option. The new file is designated by the D
Bsuffix ".T" added to the original name. The original file is left F
Dundisturbed. When loaded into AppleWorks, the file may not properly =
;word wrap. This is easily corrected by changing any margin
justification.
AWP File Doctor.H
F     When an AWP file is damaged, it cannot be loaded into AppleWorks G
Einstead the 'Getting error trying to read ...' message is displayed. C
AThe AWP File Doctor will almost always restore the non-corrupted F
Dportions of an AWP file to a new file that can be loaded into AWKS. @
>The restored file has the suffix ".D" added to the file name. F
DAsterisks replace the bad bytes, however, if the bad bytes are text H
Fcharacters, these characters may be displayed. The characters usually H
Fmake no sense and are easily identified. Except for the damaged text, $
the new file requires no revision.F
D     If the file is loaded into AWKS 2.x and the 'Getting error .." G
Emessage is still displayed, first convert the file to AWP 2.x format >
using Convert AWP 3.0 to 2.x, reload the file and try again.
Exhume AWP.G
E    If the file is so damaged that AWP File Doctor cannot repair it, G
Ethen Exhume AWP should be tried. Exhume AWP restores the AWP file by @
>searching for text characters. The restored file contains all H
Fcharacters in the text character range. Thus text characters that are @
>not part of the original text will be included (frequently an A
?additional character at the beginning and end of a text line). F
DNon-text characters are replaced with an asterisk. If the number of A
?characters exceeds 79 only one line of asterisks is added. The ;
repaired file has the suffix ".E" added to the file name.G
E     The exhumed file when loaded into AWKS must be edited to remove E
Cspurious characters and add any text that may have been corrupted. I
GThis is the hard part of the repair, but usually not as hard as having )
to rewrite the whole file from scratch.H
F     It is suggested that a damaged AWP file be processed by both the I
GAWP File Doctor and Exhume AWP. The former will reconstruct almost all H
Fof the file in a form requiring virtually no revision. The latter may $
extract a few more words of value.
Restore ADBH
F     If an AppleWorks Data Base (ADB) file is corrupted, the file can G
Ebe restored with Restore ADB. Damage can occur within a category, to B
@individual records or to the header. Damage limited to within a G
Ecategory is flagged with an asterisk. If one or more categories have D
Bbeen damaged, the entire record (or contiguous records) cannot be G
Erestored and the first category in the record(s) is flagged with the E
Cmessage '** DAMAGED RECORD(S) **'. When this message occurs as the ?
first record, a report record may actually have been damaged.H
F     If the file header is damaged, a standard header is substituted, A
?which contains 30 categories. Category names may or may not be G
Erestored depending on whether the names were damaged. Report formats I
Gwill be lost and have to be reentered. Occasionally, if the file still I
Gcannot be loaded into AWKS after processing with Restore ADB, the file I
may still be restored by forcing the standard header. This can be done A
?by pressing the Closed Apple (Option) key when the ADB file is @
>selected. Except for the first category, which will be titled F
'Category
1', all the remaining category names will be hyphens.     H
______________________________________________________________________
D     NOTE: AWP File Doctor, Exhume AWP and Restore ADB will restore H
Ffiles with bad blocks. The message '** BAD BLOCK **' is inserted when F
Da bad block is encountered. These utilities cannot repair a file if F
Dthe volume directory or subdirectory are damaged (and sometimes the H
Ffile index blocks pointing to the data blocks in the file). If one of F
Dthe directories is damaged, I suggest using the ProSel utility, Mr. (
&Fixit or my new utility, RESURRECTION.B
If you have a file that cannot be restored and the various I
Gdirectories are intact, please send it to me so that I can improve the I
Galgorithms used in the AWKS and ADB repair utilities. Copy the disk on H
Fwhich the file exists using a nibble copying utility such as Copy II+ &
and send the copy, not the original.E
Occasionally, when several blocks have been damaged, AWP File F
DDoctor will produce a new file that cannot be loaded into AWKs. Try I
Gusing AWP File Doctor again on the new file. This will usually restore #
the file. If not, use Exhume AWP.H
______________________________________________________________________
View file.E
C     This utility will read any file with word-wrap. It works best A
?with text files. Control characters are presented in uppercase F
Dinverse. If the file is an AppleWorks word processor (AWP) file (AW H
F3.0 and lower versions), it will automatically read it properly. This I
Gallows you to rapidly review TXT or AWP files in order to determine if #
you wish to use or convert them. G
View no longer scrolls. Reading the scrolling screen has always I
Gbeen a problem for the handicapped, and an impossibility for those who G
Euse an accelerator chip. The spacebar allows you to step through the F
Dfile twenty-one lines (one screen) at a time. The RETURN key aborts E
Cthe file. Any other key allows line by line step through. The left ,
margin is automatically set for AWP files.A
For convenience, the file may be output to a printer. The E
Cprinter output is set to slot 1. If you use a different slot, then E
Cchange the low nibble of byte $04 (C1) to the slot number. This is H
Fmost easily accomplished using a block editing utility such as ProSel C
ABlock Warden. Alternately the following patch will suffice after =
setting the prefix to the directory containing CHANGE.FILE.
POKE 768,19n  (where n = slot number + 2)1

BSAVE CHANGE.FILE,TSYS,A$300,L1,B4
Change file info.A
?     Any file type can be altered. You are responsible for the G
Ealteration. No checking is done. Following selection of the file(s), H
Fthe previous file type is presented at the cursor and can be accepted D
Bas the default by pressing RETURN. Alteration can be accomplished D
Busing the designated file type abbreviations displayed (e.g. BIN, ?
=TXT). Or, if the abbreviation is not listed, by entering the $
hexadecimal code (e.g. $04, $06). H
F     After the file type code is accepted, the auxiliary type code is G
Epresented and can be altered by entering the appropriate code at the I
Gcursor. When the auxiliary type code is governed by the file type code C
A(e.g. SYS always loads at $2000), the appropriate default can be 2
accepted by pressing RETURN or the mouse button.I
G     The file access code can then be altered. The file can be toggled H
Flocked or unlocked, or each of the recognized bits in the byte can be 9
7separately toggled. The bits are 7 (Destroy-enable), 6 F
D(ReName-enable), 5 (BacKUp-needed), 2 (INVisibility, GS/OS only), 1 G
E(WRiTe enable), 0 (ReaD-enable). If the bit is set (1), then the bit G
Eis enabled. If cleared (0), then the bit is disabled. If bits DES,RN H
Fand WRT (7,6,1) are all set, then the file is considered unlocked. If H
Fany of these bits are cleared then the file is considered locked. The D
Bright and left arrows and the mouse move the cursor. The spacebar F
Dtoggles whether the file is locked or not as well as the individual H
bits. The RETURN key or the mouse button accepts the displayed values.E
C     NOTE: The changes in this section are not written to the file H
until the final RETURN. ESCape always sends you back to the main menu.
Line feed stripper.E
C     This utility strips line feeds that follow a carriage return. ?
Only text files are accepted. The original file is preserved.A
For those wishing to read from the UNIX system, press the I
GOpen-Apple as well as the return key at the informational screen. This 3
will convert all line feeds to carriage returns. :
The altered file is designated with an ".L" suffix.
Strip control character.E
C     A specific control character or all control characters can be D
Bremoved. If the specified control character is 'M' (e.i. carriage D
Breturn), then a space is substituted for the carriage return. The G
Econtrol character strippers designate the altered file with the ".C"
suffix.
Insert line feed after carriage return.?
Some users apparently wish to communicate with Big Blue H
Fmachines. This utility inserts a line feed after each carriage return H
in a text file, which is required by IBM and IBM compatible computers.:
The altered file is designated with an ".I" suffix.
F     When converting files or stripping a control character with only F
one disk drive, the source and destination volumes must be the same.
Icons
E     CF.RES.ICONS contains Change-A-File and Resurrection icons. The G
EChange-A-File icon is courtesy of Karl Bunker. To use these icons in G
Ethe Finder, place CF.RES.ICONS in the ICONS subdirectory of the boot H
Fvolume (BOOT.VOLUME/ICONS/CF.RES.ICONS) and reboot.  The two programs 7
must have file names of CHANGE.FILE and RESURRECTION.
     Suggestions, bugs and other trivia to:
        Compuserve [75156,2436]
        GEnie [H.PORTNOY]
O========<=====<================================================================
All rights reserved.
AppleWorks, copyright Claris Corporation
ProSel, copyright Glen Bredon2
Copy II+, copyright Central Point Software, Inc.
Recent version updates:5
3.00- Correct minor bug in directory input.C
3.01- Correct bug in filetype listing when over 66 files."
3.02- Minor improvement.0
3.03- Correct bug in Restore ABD File.3
3.05- Correct bugs in directory selector.)
4.0 - Major revision in format.5
4.01- Correction of bug when used on IIC's.@
4.02- Correction of bug in control character stripper.0
4.03- Correction of bug in TXT to AWP.C
4.04- Correction of bug in TXT to AWP and printer output.B
4.05- Controlled scroll and word-wrap in View plus other#
 minor impovements.7
4.06- Some minor bug corrections and changes.8
4.1 - Improved recovery of ADB report formats.3
4.11- Bug fix in Strip Control Character.?
4.12- Password works correctly with Resurrection 2.7.&
4.14- Improved password use..
4.15- Minor bug fix in ProDOS input.%
4.16- Bug fix in Repair ADB+
4.17- Bug fix in Change File Info